home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr48 / 3dlib17f.zip / 3DO.DOC < prev    next >
Text File  |  1993-03-15  |  6KB  |  132 lines
  1.  
  2.  ╔══════════════════════════════════════════════════════════════════════════╗
  3.  ║                                                                          ║
  4.  ║                                 ISoft D&M                                ║
  5.  ║                                 POB. 5517                                ║
  6.  ║                           Coralville IA 52241                            ║
  7.  ║                                   U.S.A                                  ║
  8.  ║                                                                          ║
  9.  ╚══════════════════════════════════════════════════════════════════════════╝ 
  10.  
  11. *******************************************************************************
  12. *                              3dO Documentation                              *
  13. * object compiler docs file, V1.7                                             *
  14. * Last Update : Mar. 10, 1993.                                                *
  15. *******************************************************************************
  16.  
  17. *******************************************************************************
  18. *                                INTRODUCTION                                 *
  19. *******************************************************************************
  20.  
  21. 3dO is an object compiler that converts text 3d object definitions into
  22. 3d object files.
  23.  
  24. The objects created with the 3dO object compiler can be used by 3d simple
  25. objects load method.
  26.  
  27. The 3dO program is an alternate way of creating object files, to the
  28. method that was used up to date, of creating the 3d objects with the
  29. 3d program. (Aailable in another diskette/package).
  30.  
  31. *******************************************************************************
  32. *                                    USAGE                                    *
  33. *******************************************************************************
  34.  
  35. At the command line type 
  36.  
  37. 3DO input[.3dd] [options]
  38.  
  39. where input.3dd is the name of the object definition source.
  40.  
  41. The 3dO program will create a 3d object (.3d2) file for each SIMPLEOBJECT
  42. statement from the original source.
  43.  
  44. *******************************************************************************
  45. *                         OBJECT DEFINITION LANGUAGE                          *
  46. *******************************************************************************
  47.  
  48. The 3dO program processes a language that is built out of series of
  49. statements. 
  50.  
  51. A statement can be specified on multiple lines, if this is the case,
  52. a continuation mark character MUST be placed at the end of the line.
  53. The continuation mark line recognized is the '+' (plus) sign.
  54.  
  55. The SIMPLEOBJECT statement syntax is as follows :
  56.  
  57. SIMPLEOBJECT object-name [NOGEN] +
  58.   POINT point-num x-value y-value z-value +
  59.   POINT ..... +
  60.   LINE from-point to-point +
  61.   LINE ... +
  62. END-OBJECT
  63.  
  64. Where object-name is the name of the object file, multiple 3d points can
  65. be specified with the POINT sub-statement, where point-num is a pointer
  66. into the 3d point array, with x-, y- and z-value the values in the x, y and
  67. z dimensions.
  68. Multiple lines are defined using the LINE sub-statement, where from-point and
  69. to-pointsw are pointers into the 3d points array, that describe the 
  70. edges of these lines.
  71. If the optional NOGEN option is specified a stand alone simple object will NOT 
  72. be generated, this is usefull if the simple object is used as part of a complex
  73. object.
  74.  
  75. The COMPLEXOBJECT statement syntax is as follows :
  76.  
  77. COMPLEXOBJECT object-name +
  78.         CHILD child-name [AT x y z] .. +
  79. END-OBJECT
  80.  
  81. Where object-name is the name of the complex object that will be generated,
  82. child-name is the name of the simple object that will be inserted as a child
  83. to the complex object. 
  84. The optional AT parameter TRANSLATES (moves) the child object to the requested 
  85. position in the 3D space. (for an example of a complex object definition please
  86. refer to the twopyr.3dd sample file provided with this package).
  87.  
  88. Please refer to one of the supplied *.3DD files (e.g. twolayer.3dd) for
  89. an example for the usage of this statement.
  90.  
  91. *******************************************************************************
  92. *                                   General                                   *
  93. *******************************************************************************
  94.  
  95.   3dLIB is distributed by ISoft D&M, P.O.B. 5517 CORALVILLE IA 52241, U.S.A.
  96.   
  97.   3dLIB is (c) copyrighted by Loewy Ron, 1991,93.
  98.  
  99.   3dLIB is a shareware package, please register your copy. 
  100.   To register your copy of 3dLIB please refer to the supplied
  101.   3DLIB.REG file. 
  102.  
  103.   Other programs distributed by ISoft D&M are described in the supplied  
  104.   PROGRAMS.TXT file.
  105.  
  106. *******************************************************************************
  107. *                                   Contact                                   *
  108. *******************************************************************************
  109.  
  110.   Please contact :
  111.  
  112.   ISoft D&M,  
  113.   P.O.B 5517
  114.   Coralville IA 52241,
  115.   U.S.A
  116.  
  117.   To contact the author directly : 
  118.  
  119.   Contact :     Loewy Ron,
  120.                 9 Haneveem st.
  121.                 Herzeliya, 46465
  122.                 ISRAEL.
  123.  
  124. *******************************************************************************
  125. *                                   Credits                                   *
  126. *******************************************************************************
  127.  
  128.   3dLIB and 3dO were written using Turbo Pascal V6.0, Turbo Pascal
  129.   for Windows V1.5 and Borland Pascal with objects V7.0, trademarks 
  130.   of Borland International.
  131.  
  132.